package com.frank.oss.adapter;

import com.frank.oss.eneity.FileInfo;
import org.springframework.web.multipart.MultipartFile;

import java.io.InputStream;
import java.util.List;

/**
 * @author Frank Zou
 * @version v0.0.1
 * @date 2024/2/1 22:24
 * @description
 */
public interface StorageAdapter {

    /**
     * 创建 Bucket 桶
     *
     * @param bucketName bucket name
     * @throws Exception exception
     */
    void createBucket(String bucketName) throws Exception;


    /**
     * 上传文件
     *
     * @param multipartFile 上传的文件
     * @param bucketName    bucket name
     * @param objectName    object name
     * @throws Exception exception
     */
    void uploadFile(MultipartFile multipartFile, String bucketName, String objectName) throws Exception;

    /**
     * 列出所有的桶
     *
     * @return buckets
     */
    List<String> listBuckets() throws Exception;

    /**
     * 列出所有文件
     *
     * @param bucketName 桶名称
     * @return 所有的文件
     * @throws Exception exception
     */
    List<FileInfo> getAllObjects(String bucketName) throws Exception;

    /**
     * 下载文件
     *
     * @param bucket     桶名称
     * @param objectName 文件名称
     * @return 文件流
     * @throws Exception exception
     */
    InputStream download(String bucket, String objectName) throws Exception;

    /**
     * 删除桶
     *
     * @param bucketName bucket name
     * @throws Exception exception
     */
    void deleteBucket(String bucketName) throws Exception;

    /**
     * 删除桶里面的文件
     *
     * @param bucketName bucket name
     * @param objectName object name
     * @throws Exception exception
     */
    void deleteObject(String bucketName, String objectName) throws Exception;

    /**
     * Get url
     * @param bucketName bucket
     * @param name name
     * @return url
     */
    String getUrl(String bucketName, String name);
}
